Reference Manual


Iso14L4.SetupAPDU

Setup communication parameters and select a certain PICC for APDU exchange. The chosen settings will be applied to all subsequent calls of the Iso14L4.ExchangeAPDU and Iso14L4.Deselect commands.

The FrameParam and Bitrate parameters have to be chosen according to the PICC's capabilities.

In some cases, the CID of the label to select has to be passed as a parameter. This is the case if the label supports the feature of being assigned a CID, and if a CID value has been previously assigned to the PICC using the Iso14a.RequestATS command (for ISO 14443 Type A labels) or by the or the Iso14b.Attrib command (for ISO 14443 Type B labels). Otherwise, the CID functionality should be disabled, by clearing the EnCID flag.

PICCs which do not support a CID (for which the returned CID value from the Iso14a.RequestATS command, or from the Iso14b.Request command, is 0x00) will only respond to the Iso14L4.ExchangeAPDU and Iso14L4.Deselect commands if the CID functionality is disabled.

A PICC, which supports a CID, will

  1. respond to the Iso14L4.ExchangeAPDU and Iso14L4.Deselect commands only if the CID functionality is enabled and if the specified CID value matches the PICC's own CID value.
  2. ignore the Iso14L4.ExchangeAPDU and Iso14L4.Deselect commands if a different CID value is specified.
  3. also respond to Iso14L4.ExchangeAPDU and Iso14L4.Deselect commands with a disabled CID functionality, if its own CID value is 0.

The NAD parameter may be used to select a certain logical application (node) on the target PICC, if these are supported by this PICC.

Properties

Parameters (request frame)

Name Type/Size Description
- Bit mask (8 bits) -
RFU Integer (bit mask area 0xF0) Zero padding
EnDefault Boolean (bit 0x08) If this flag is set, the default settings for FrameParam and Bitrate will be applied instead of the given parameter values.
ToggleAB Integer (bit 0x04) If this flag is set, communication with the PICC will be performed according to the ISO 14443 Type B standard. Otherwise, communication will be performed according to the ISO 14443 Type A standard.
EnNAD Boolean (bit 0x02) Enables the NAD functionality.
EnCID Boolean (bit 0x01) Enables the CID functionality.
CID Integer (8 bits) Specifies a CID value, which shall be used for all subsequent calls of the Iso14L4.ExchangeAPDU and Iso14L4.Deselect commands. If EnCID is not set, this parameter will be ignored and the CID functionality will be disabled.
NAD Integer (8 bits) Specifies a NAD value, which shall be used for all subsequent calls of the Iso14L4.ExchangeAPDU command. If EnNAD is not set, this parameter will be ignored and the NAD functionality will be disabled.
- Bit mask (16 bits) -
FSCI Enumeration (bit mask area 0xF000) Frame Size proximity Card Integer (FSCI). This value is mapped to the Frame Size proximity Card (FSC) value, which indicates the maximum frame size accepted by the PICC. The possible FSC values (mapped to the FSCI index) are listed below.
Values:
  • Bytes16 (0x0)
  • Bytes24 (0x1)
  • Bytes32 (0x2)
  • Bytes40 (0x3)
  • Bytes48 (0x4)
  • Bytes64 (0x5)
  • Bytes96 (0x6)
  • Bytes128 (0x7)
  • Bytes256 (0x8)
FWI Enumeration (bit mask area 0x0F00)

Frame Waiting time Integer (FWI). This value is necessary for calculation of the Frame Waiting Time (FWT) value, representing the maximum time needed by the PICC between receiving a frame and sending the corresponding answer. FWT is calculated by:

FWT = (256 * 16 / 13.56 MHz) * 2 ^ FWI

The FWT values given here (mapped to the FWI index) are approximate.


Values:
  • Us302 (0x0)
  • Us604 (0x1)
  • Us1208 (0x2)
  • Us2416 (0x3)
  • Us4832 (0x4)
  • Us9664 (0x5)
  • Ms19 (0x6)
  • Ms39 (0x7)
  • Ms77 (0x8)
  • Ms155 (0x9)
  • Ms309 (0xA)
  • Ms618 (0xB)
  • Ms1237 (0xC)
  • Ms2474 (0xD)
  • Ms4948 (0xE)
RFU Integer (bit mask area 0x00F0) Zero padding
DSI Enumeration (bit mask area 0x000C)

Divisor Send/Receive Integer (DSI/DRI)

This parameter is mapped to the Divisor Send/Receive (DS/DI) value, which determines bit rate for sending data from PICC to PCD. The possible DS/DR values (mapped to the DSI/DRI index) are listed below.


Values:
  • Kbps106 (0)
  • Kbps212 (1)
  • Kbps424 (2)
  • Kbps848 (3)
DRI Enumeration (bit mask area 0x0003)

Divisor Send/Receive Integer (DSI/DRI)

This parameter is mapped to the Divisor Send/Receive (DS/DI) value, which determines bit rate for sending data from PICC to PCD. The possible DS/DR values (mapped to the DSI/DRI index) are listed below.


Values:
  • Kbps106 (0)
  • Kbps212 (1)
  • Kbps424 (2)
  • Kbps848 (3)

Returned values (response frame)

None